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DECmate IIL: 


Word Processing 


Learning the Basics 


Word Processing Primer 


Teaches you word pro- 
cessing basics such as 
creating, editing, print- 
ing and copying docu- 
ments using a quick, 
step-by-step format. This 
manual also tells you 
where to go next and 
what to do if you have 
problems with DECmate. 


Introduction to 
Word Processing 


Teaches you basic word 
processing: how to create, 
edit and print docu- 
ments. This self-paced 
course contains two disk- 
ettes (Introduction to 
WPS-—Drive 0 and Intro- 
duction to WPS—Drive 1) 
and a card to get started. 


Getting Started 


The System Overview 


Teaches you how to iden- 
tify the system parts, 
and handle diskettes. 
This self-paced course 
contains one diskette. 
Read Chapter 6, Using 
the System Overview 
Diskette, in the 
DECmate II Installation 
Guide (order number 
EK-—DECM2-IN) to be- 
gin the course. 


Getting Started Card 


Teaches you how to turn 
ON your word processing 
system, activate features, 
initialize a document 
diskette, and back up the 
system diskette. It also 
tells you who and when 
to call for help. 


Reference 


User's Guide: 
Volumes 1 & 2 


Explains DECmate II 
word processing proce- 
dures. Volume 1 contains 
basic word processing 
tasks: how to create, edit 
and print documents. 
Volume 2 contains 
advanced word process- 
ing tasks such as pagina- 
tion, text manipulation, 
document searches and 
control commands. 


Quick Lookup Guide 


Summarizes basic word 
processing procedures. 
This guide is organized 
by tasks, such as creat- 
ing or printing text. If 
you are an experienced 
user, read this guide 

to review basic word 
processing. 


Note: You should be 
familiar with basic word 
processing procedures before 
using the optional features. 


Optional Features 


Using Communications 


Teaches you how to use 
Communications. Com- 
munications lets you 
send information to and 
receive information from 
other computer systems. 


Using Math 


Teaches you how to use 

Math. Math lets you do 

arithmetic while editing 
documents or using List 
Processing. 


Using List Processing 


Teaches you how to use 
List Processing. List 
Processing lets you print 
the same document (such 
as a form letter) many 
times, varying certain 
information from copy to 
copy. 


Using Sort 


Teaches you how to use 
Sort. Sort lets you 
arrange lists of informa- 
tion in alphabetical or 
numerical order. 
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Preface 


PRODUCT NAME: DECmate II/WPS 
VERSION: 1.0 


List Processing operates with DECmate ™ II basic word processing soft- 
ware to merge units of information with repeated text to create indi- 
vidualized documents. 


How to Use This Manual 


You should know basic DECmate II word processing operations, but you do 
not need prior experience with List Processing. 


etal If You Are a New List Processing User 


Chapters 1—4 contain the basics of List Processing, and show you how to 
create a mailing list and form letter, and how to merge the two. Chapter 5 


ie provides details about how to create more specific applications for List Pro- 
cessing. Chapter 6 summarizes List Processing. The glossary contains List 
a Processing terms. 
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Preface 


If You Are an Experienced List Processing User 


Read Chapter 2, Activating the List Processing Feature, to make sure List 
Processing is available on your diskette. Then read Chapter 6 for a sum- 
mary and review of list processing. Try the exercises in Chapters 3 and 4. 


Conventions 


Dot Matrix 


<field name> 


Rubout key 


ALL CAPS 


Gold XXX 


Type 


Press 


<> key 


Vill 


Text printed in dot matrix appears on the screen. 


Text inside angle brackets is a field name for List Process- 
ing, Sort, or Math. 


The key marked with a symbol used to rub out 
functions. 


< xX] Word 
Char 
The function or editing key to press. 


For example: press ADVANCE. 


Press the Gold key and then a function key. 
For example: Gold MENU. 


Enter text into a document from the keyboard. 


Enter a command from the keyboard. 
For example: press DEL WORD. 


The key in the lower right corner of the Editor keyboard, 
labeled <> on the top, also marked ENTER. 
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Overview 


What Is List Processing? 


List Processing is an optional feature that you can add to your DECmate 
word processing software. It lets you produce many form letters and other 
documents with a minimum of typing. 


You can use List Processing to: 


Create personalized letters describing a new product or service. 


Select customers who owe money and produce letters asking 
them to pay. 


Produce a directory of customers. 


Produce a telephone directory for a company, a list of purchase 
orders, or any other type of list. 


Create a single form to produce a series of monthly reports. 


Before using List Processing, you must create a list document, a form 
document, and a selection specification document. These documents are 
explained in the following section. 


Overview 


<titleomr,. 
<name>Cleveland 

<first> Grover 
<street>15G High Pine Ave 
<city>Boston 


Dear <title> <name>» 


The East Coast Bank is pleased 


éstaterMA to announce a new checking plan 

£21 p>02739 that is available to all <city> 

es residents. We would like to take 
this opPortunityee. 


<title>Ms, 

<name>Nation 
<firstoCarrie 

<street>1d Abolition St. 
<city-AtKinson 

<state>NH 

€zip>03033 

<> 


<title>Mr. 
<name >Haves 


If <city>=Boston 
then Process record 


Dear Mr. Cleveland, 


The East Coast Bank is pleased to announce a 
new checking plan that is available to all 
Boston residents. We would like to take this 
opportunity... 


MK-00836—00 


Figure 1 How List Processing Works 
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Overview 


The List Document 


The list document contains sets of related information. If you are producing 
letters, the list document might be a mailing list with names and addresses. 
Doing List Processing inserts the name and address of each person into the 

form document to produce the letters. 


The Form Document 


The form document is the text you want List Processing to print repeatedly. 
It is the model that each printed copy follows. 


The Selection Specification 


A third document, the selection specification, tells DECmate which records 
to select from the list document. You can send the letter to everyone on 
your list, or you can select specific people to send letters to. 


Figure 1 illustrates how List Processing works. 
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Activating List Processing 


List Processing is an optional feature that you must activate on your system 
diskette before using it. You need to activate the feature only once. 


To activate this feature, you need: 1) the List Processing feature diskette 
(labeled WPS LIST PROCESSING RX50), and 2) a system diskette (labeled 
WPS THE BASICS RX50). 


Is List Processing Already Active? 


List Processing may already be active on your system diskette. To check if 
it is, first display the Diskette Maintenance Menu (see Figure 2) by typing 
MC and pressing RETURN. 


Select the A option and press RETURN. The Activate Features Menu 
appears (see Figure 3). 


Activating List Processing 


Type the let ter(s) and t pre ce RETURN ane ae 


OR Press Gold MENU to re fhe Main Menu, 


Figure 2. The Diskette Maintenance Menu 


3 MENU -- | Wa ee /25/82 Tue 2:51:33 


optional features are av 


n optional feature? Pl 
tte into Drive 1 and Pp 
NU to recall the Main Menu 


Figure 3. The Activate Features Menu 
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Activating List Processing 


If Active appears before List Processing Option, then List Processing is 
active. Press Gold MENU to recall the Main Menu. Turn to Chapter 3 for 
instructions on how to use the feature. 


If Not Active appears before List Processing Option, activate the feature as 
explained in the next section. 


To Activate List Processing 
While the Activate Features Menu displays: 
1 Remove any diskette in drive 1. 
2 Put the List Processing feature diskette in drive 1. 
3 Leave your system diskette in drive 0. 
4 Close both drive doors. 
5 Press RETURN. 


DECmate checks drive 1 to make sure it contains a feature diskette. If it 
does, DECmate activates the feature, and you see this message: 


-- Activating Special Feature Option -- 
Activation in Progress: Please stand byes, 


The activating process takes less than a minute. During this time noises 
come from the drives. When the activating process is complete, the Activate 
Features Menu reappears, showing the List Processing feature as Active. 
See Figure 4. 


Press Gold MENU to return to the Main Menu. Type M and press RETURN 
twice to view page three of the Main Menu. The List Processing (LP) option 
should now be included. 


Activating List Processing 


atures are. 


Beste Herd. ‘Proces¢ing. 
Communications Ortion 
~ List Processing. Ortion 
. Sort Option : 

Math ‘Option. 


“an optional feature: Place the aprrorriate: aig Coe 
RE Kette into. Drive 1 and press RETURN? or ee 
Go q MENU to recall: the Main Menu. : 


Figure 4 List Processing Activated 


Remove the List Processing feature diskette from drive 1, and save it in 
case you need it again. 


NOTE: When you are finished activating your optional features, make a 
backup copy of your system diskette. 


lf List Processing Does Not Activate 


Check to see which feature diskette you are using. You may have activated 
another feature. 


If List Processing does not activate, you may see one of these system mes- 
sages during the activation process. 


Drive 1 does not contain a valid FEATURE diskette, 


Ogilable on vole disketve: 
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Activating List Processing 


There is an invalid feature diskette, such as a damaged feature diskette or 
an ordinary document diskette, in drive 1. 


Press RETURN to recall the Activate Features Menu. Put the correct fea- 
ture diskette in drive 1 and press RETURN. 


Error on drive i while trying to read block (number). 


An error developed during the activating process. The drive door might not 
be securely closed, or the drive cannot read the feature diskette. 


Make sure the drive doors are securely closed. You cannot verify the feature 
diskette. 


If you still cannot activate the feature, you may have a problem with your 
terminal. See the DECmate II Owner’s Guide (EK—DECM2-—0M-001). 


NOTE: If you use List Processing with either Math or Sort, those features 
must also be active on your system diskette. 
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Basic List Processing 


In this chapter you will learn how to create: 


e 6A list document 
e §6A form document 


e 6A selection specification document 


In the next chapter, you will run List Processing to produce form letters. 


Creating a List Document 


You create a list document as you do any other document, by typing C from 
the Main Menu and giving it a name. 


A list document is a collection of information that List Processing merges 
with a form document. 


A list is made up of records. Records are made up of individual fields. 
Records and fields must conform to simple but strict rules for DECmate to 
use them correctly. 
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Basic List Processing 


Records 


The list document is divided into records. Each record contains information 
about a single person or thing. 


€titlezMr. 
Lfirst?zAbraham 
€lasteLincoln 


€street?123 Main St, This is an example of a 
<city lexington record. 
{state sky 


<zip>06565 
4? 


If the list document is a personnel file, each record contains information on 
a single employee. If the list document is an inventory list, each record con- 
tains information on each separate part. 


Each record can have up to 2500 characters, including field names, angle 
brackets, and other characters. 


Each record must end with a diamond <>, created by the left and right 
<angle brackets>. In a list document, a record is defined as all fields 
between two diamonds or all fields before the first diamond. 


When typing a record, press RETURN twice after typing the diamond. 
Pressing RETURN twice adds a blank line between records and makes it 
easier to tell where one record ends and another begins. You can use the 
PARA key to move from one record to the next. 


Fields 


Each record is made up of fields. A field consists of a field name inside 
<angle brackets> and the field value. The field value is the text following 
the right angle bracket > that ends the field name, up to the next left angle 
bracket. 


field name —** 


<citysLlexington 


field value 


{2 


Basic List Processing 


Field Names. The field name is the text between the left and right 
<angle brackets>. The following record contains fields named street, city, 
state, and zip. 


{streete123 Main Street 
fcityelexington 
<staterky 

€zipzsO2140 


é> 
The three restrictions on a field name are: 


4 It must not include angle brackets, > or <, since these are used to 
mark the beginning or end of the field name. 


2 It must not start with an exclamation point, !. Some field names 
starting with !, such as <!S>, are special commands (see 
Chapter 5). 


3 It must not be longer than 30 characters. 


The name you give a field should indicate the meaning of its value. For 
instance, if you are creating records with people’s names, use <first> and 
<last> as field names, instead of <f> and <I>. 


Typing Field Names. You must always type a field name in exactly the 
same way. Use the same spaces and uppercase or lowercase letters each time 
you use that field name. If you have a field called <address> in some 
records, be sure you type <address> in all other records and related 
documents. 


You must always be consistent with your field names. If you have used 
<address> in your list document, you must not type the following varia- 
tions in your form document: 

e <ADDRESS>, since it has all capitals 

e <Address>, since it has an initial capital 

e < address >, since it has spaces 


DECmate cannot recognize any variations of the field name, so it cannot 
select any field but <address>. 
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Basic List Processing 


Field Values. A field’s value is the text after the field name. The value is 
the information that will go into the form document. Type the field value 
exactly as you want it to appear. Any spaces, tabs, or invisible characters 
that you type after the right angle bracket (>) that ends the field name 
become part of the field value. The field value ends at the next left angle 
bracket (<). 


Press the < > (ENTER) key on the Editing keypad to automatically 
advance or back up to the start of a field value. This saves you time when 
typing in field values. 


When you type a list document, press RETURN after each field value. The 
next field appears on the following line. For example: 


{title>Mr. (RETURN) 

<first?Theodore (RETURN) 
<last?Roosevelt (RETURN) 
¢<address?407 San Juan Hill (RETURN) 
Cambridge,» Mass. O2140(RETURN) 

<> 


A hard return immediately before a left angle bracket < is not part of any 
field value. All other hard returns in a field are part of that field’s value. 
They appear in the processed copy. 


For example: The hard return after the word Mr. is not part of the field 
<title>. But the return after Hill is part of the field <address>. When 
DECmate inserts the value of <address> into the output document, it 
inserts a hard return after Hill. 


NOTE: If the character just before the start of the next field name is a space, 
a tab, or a line-end character, it is not part of the field value. 


What to Include in a List 


When creating a list document, you must determine what information you 
need to include for your business. 


14 


jJdgpds)9)3)5id 


J 


q 


Basic List Processing 


In a letter, you usually use people’s names in the following three ways: 


Address: You use the full name, including any titles, suffixes, or 
degrees: 


Mr. Chester A. Arthurs Jr. 
Salutation: You use an abbreviated form: 
Dear Mr. Arthurs 
Body: You refer to the person by first name: 
All of us at the Southport Book Store would like 


to thank your Chester» for your Patronage in the 
Past y@aress 


If you think you may use all three styles, you should include five separate 
fields in each record of your list document. For example: 


€titlezMr. 
<first?2Chester 


<middle> A, (note the space) 
<lasteArthur 
suffixes Ir. (note the comma and space) 


fs, 
~ 


In the fields <middle> and <suffix>, spaces and a comma are part of the ~ 
field’s value. They are included here instead of in the form document. In 
records where the <middle> and <suffix> fields are empty or missing, you 
do not want DECmate to insert these spaces and comma. So put them in the 
list document, not the form document. 


If your list includes a married woman, such as Mrs. James Madison, make 
sure you do not process the list through a form document that refers to 
people by first names alone. For example: 


Dear Mrs. Madison: 


All of us at the Southport Book Store would like to thank yous 
James» for your Patronage in the Past yvy@aress 
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Basic List Processing 


You can solve this problem by including two first name fields in all records: 
one for formal address, one for familiar address. Then a record looks like 
this: 


<title>Mrs, 
¢formal>James 
¢familiar>Dolly 
<last?Madison 
<> 


Including these field names in a record also lets you use a nickname in the 
field <familiar>. 


More on Creating a List 


e List Size 


Avoid long list documents by creating several specific list docu- 
ments. For example: Customers Since July 1, or Customers A—D. 
This method allows you to use FR and TO effectively. 


e Order of Records 


List Processing processes records in the order they appear, begin- 
ning at the top of the list document. If you are preparing personal- 
ized form letters, the order of the records probably does not matter. 


If the order of the records does matter, insert each new record in the 
list document in the order you want. For instance, to produce a table 
with lines in alphabetical order by last names, insert records into 
the list document so that the <last> field is in alphabetical order. 


You can use Sort to arrange records from a list document in a speci- 
fied order. You must first purchase the Sort feature and have it 
active on your system. For more information, see Using Sort 
(AA—-N185A-TA). 


e Order of Fields 
The order in which you type the fields in a record does not matter. 
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Basic List Processing 


In this example, both ways are correct. 


<title>Mr, 
<first?zAbraham 
<last?Lincoln 
faddress?123 Main St, 
Lexington+ Mass, 
02940 

flasteLincoln 
<firsteAbraham 
é<titlesMr,. 
f<address?123 Main St. 
Lexingtons Mass. 
02940 


. 


Printing a List Document 


~ You can print your list document, since the list document is an ordi- 
nary word processing document. You can include highlighting, 
rulers, print control commands, and invisible characters. They work 
in the usual way when printing a list document. 


Using Numeric Fields 


Any time you include numbers in a field value, consider making 
that field a numeric field. List Processing can work with the Math 
feature, allowing you to perform math calculations on your field 
values. For more information on the Math feature, see Chapter 5, 
and Using Math (AA-N186A-TA). 
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Exercise 1: Create a List Document 


In this exercise, you will create a customer mailing list. Use a new, initial- 
ized diskette and save the results of each exercise. In the next chapter, you 
will combine this list with a form document and selection specification docu- 
ment to produce form letters when you run List Processing. 


4 Create the list document with the name Customer List Document. 
Type in the following fields: 


{date> 
<title> 
“first? 
“familiar: 
flast? 
frlimit? 
taddress? 
i? 


Press RETURN twice. 


2 Tosave time, cut and paste the record several times. To cut and 
paste, press BACK UP, PARA, SEL, PARA, GOLD CUT. The 
blank record is now in the paste area. Press PASTE three times. 
Now you have four blank records. 


3 Go back to the top of the list document. Press the < > (ENTER) 
key to move the cursor to the end of each field name. Fill in the 
records as shown below. You can use the Gold DATE & TIME 
key to insert today’s date. 


«date? 

<title Mr, 

<first+Abraham 

¢familiar>Abe 

<lasteLincoln 

Crlimit>o 

faddress?1865 Gettysburg St. 
Lexington» MA O2540 


(continued on next page) 
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<date+> 
<titlerMr. 
¢first?George 
<familiar?:George 
flast?Washington 
<:limit?100 


address Mt. Vernon 


Bostons MA O2301 


<date> 
etitlesMr, 
<firsteWoodrow 
<familiar?Woody 
<lasteWilson 
felimit?2s 


Aue, 


faddress 31d Points Ave, 


Yalers MA 02505 
<> 

idate> 
ttitlesMs. 
tfirst?Susan B, 
<familiar?Sue 
<last?Anthony 
ftlimit?so 


faddress?+Silver Dollar St. 


New Bedfords MA 02739 


a? 


Basic List Processing 


The field name <:limit> includes a colon because it is a numeric field. The 


properties of numeric fields will be discussed later. 


When you have finished, file this list document. 


Creating a Form Document 


The form document shows DECmate: 


What format the final output takes 


Which information can change from copy to copy 


At the end of the section is an exercise to create a form document. 
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Creating the Form Document 


You create a form document as you do any other document, by typing C 
from the Main Menu and naming the document. 


To create a form document, type the basic form letter you want to produce 
repeatedly. Where you want to use a field value from the list document, 
type the field name, enclosed in <angle brackets>. 


For instance, to produce personalized form letters using the names in a 
mailing list, type a sample letter. Put in the necessary rulers, highlighting, 
and invisible characters. But for the text that changes from letter to letter, 
type the appropriate <field name>. The field name must match the field 
name in the list document. Figure 5 shows an example of a form document. 


SOUTHPORT BOOK STORE 
Greentree Shopping Mall 
Bedford,» Mass. 01730 


Jane ls 1982 


<title> <first? <last+? 
<address> 


Dear ¢<title® <last:» 

All of us at the Southport Book Store would like to 
thank you for your Patronage in the Past year. We 
consider you one of our valued customers and look 
forward to many years of supplying your reading needs, 


Sincerely yours» 


Thomas Jefferson 
President 


Figure 5 A Form Document 
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Remember to type all <field names> the way you did in the list document. 
If you used uppercase letters in the list document, use uppercase letters for 
that field name in the form document. Likewise, use spaces in the form doc- 
ument where you used them in the list document. 


You can insert a field name in more than one place in the form. In the 
example in Figure 5, note that there are two places each where the field 
names <title> and <last> are used. 


NOTE: You do not have to use all the available fields in a record. 


If you are creating a single-page form document, such as a letter, always 
end with a NEW PAGE mark. You can include blank lines (hard returns) 
before the NEW PAGE mark. However, do not include blank lines or spaces 
after the NEW PAGE mark. These can change the placement of the follow- 
ing output documents. 


Formatting in a Form Document. 


e DECmate uses the rulers in the form document to dictate the mar- 
gins and format of the output document. 


e DECmate inserts word wraps when adding text from the list 
document. 


e DECmate adjusts hyphenated words to match the margins. Because 
you do not know where word breaks will fall in the output docu- 
ment, include invisible hyphens in long words. 


e DECmate adjusts field values to fall in their proper place in the out- 
put document, even though those field names do not necessarily 
align with the correct tab stops in the form document. 
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Exercise 2: Create a Form Document 


Create a document on your diskette named Form Letter. Type in the follow- 
ing form letter. In the next chapter you will merge it with your Customer 
List Document to create form letters. 


SOUTHPORT BOOK STORE 
Greentree Shopping Mall 
Bedford, Mass. 01730 


July 20+ 1982 


“title> <first>® ¢<last>? 
“address> 


Dear <title> <last#+ 

All of us at the Southport Book Store would like to 
thank yous <familiar?>, for your Patronage in the Past 
year. We are happy to tell you that we are Planning to 
extend our book-ordering service to include limited 
lines of credit. We are prepared to extend to you an 


account With a limit of #$<:limit+> 


If you are interested in our new services Please ask for 
details when you next stop by our store, 


Sincerely yours,» 


Thomas Jefferson 
President 


Remember to include spaces between two field names, and a NEW PAGE 
mark at the bottom of the letter. 


When you are finished, file this document. 
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Creating a Selection Specification 


This section explains the function of a selection specification document. At 
the end of this section you will create a specification document that you will 
use in the next chapter to produce form letters. 


You create a specification document as you do any other document, by typ- 
ing C from the Main Menu and naming the document. 


A selection specification (also known as specification document or simply 
spec) is actually a computer instruction that tells your DECmate how to 
select records from your mailing list. Because it is a computer instruction, 
there are simple but strict rules to follow so that the specification works 
exactly as you want. 


By testing each record, selection specifications can select every record or 
just certain records in your list. DECmate checks whether the values in 
your list agree with the selection specification. If they are compatible, 
DECmate processes them into a form. If the values are not compatible, 
DECmate goes to check the next record in the list. 


You define the fields and the acceptable values. 


Types of Selection Specifications 


To Process Every Record. If you want to process every record in the 
list document, you could create a document with the following selection 
specification: 


Process record 
This selection specification chooses every record in the list document. 


To Process Some Records. The most simple selection specification that 
can choose certain records might look like this: 


if <state2=VT 
then Process record 
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This tells DECmate to list process only those records that have a certain 
field value. For example, the records in your list might contain a field called 
<credit> with a value of either good or bad. The following selection specifi- 
cation processes only the good records: 


if «<credit?=good 
then Process record 


selection Specification Rules 


Use these guidelines when you create a selection specification. 


Make the selection specification less than 860 characters, or 20 
lines. 


Spell each field name exactly as it appears in the records in the 

list document. DECmate treats fields <credit>, <CREDIT>, and 

< credit> as different fields. Note that spaces within the angle 
brackets are treated as characters. They can change the meaning of 
the selection specification. Likewise, be consistent in using upper- 
case and lowercase letters. 


Type the field value immediately after the equal sign (=). 


The words then process record must occur on a separate line — that 
is, after a hard return. 


You can type spaces or tabs to indent each line of the selection spec- 


ification. The spaces and tabs make no difference to the instructions. 


However, do not put spaces and tabs in the field value unless you 
want to test for them. 


The text to the right of the equal sign, up to the hard return, must 
match the contents of the field exactly. DECmate attempts to match 
spaces as part of the field value. Uppercase letters match only 
uppercase letters. 


For more advanced specifications, see Chapter 5, Advanced List Processing. 
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Exercise 3: Create a Selection Specification 
Document 


In this exercise you will create a simple selection specification document. 
You will use this spec in the next chapter to merge your Customer List 
Document with your Form Document to create some form letters. 


Create a new document on your diskette named Spec. Type the following 
selection specification exactly as it appears here: 


if <:limit?=<257 or more 
then Process record 


This specification will test that each customer’s credit limit is at least $25. 
It will ignore any values under $25. 


Check that your specification matches this one exactly (including spaces). 
When you are certain they match, file the document. 


Now that you have created a list document, a form document, and a selec- 
tion specification document, you can run List Processing. Proceed to 
Chapter 4, Running List Processing. 
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There are two steps to using List Processing. The first step is to create the 
list, form, and selection specification documents. These documents are dis- 
cussed in Chapter 3. 


The second step, discussed in this chapter, is to run List Processing: to make 
DECmate produce text using these three documents. In the exercise, you 
run List Processing on the documents you created in the previous exercises. 


NOTE: You cannot use your terminal for other tasks while List Processing is 
running. 


Running List Processing 


The List Processing Menu 


Before you can run List Processing, you need the list, form, and selection 
specification documents. Once you have created these, you can run List 
Processing. 


To begin, type LP from the Main Menu and press RETURN. The List 
Processing Menu (see Figure 6) displays and offers you three options. 
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D+ Merge list with a f 


- -‘T = Test a selection sp 


Figure 6 The List Processing Menu 


Two of these options let you choose between sending the output to a docu- 
ment or to a printer. The third option tests the selection specification. The 
following sections discuss options P and D. The T option is discussed at the 
end of this chapter. 


P — Merge List with a Form and Print the Result. If you select P to send 
the output to a printer, DECmate prompts you for the list document, selec- 
tion specification, and form document. Type in the document names or 
numbers. 


DECmate displays the Print Menu of the form document. These settings for- 


mat the output document. You can change any print settings in the usual 
way. DECmate stores the print settings of the form document with that 
document. 


When the settings are correct, type YES or OK and press RETURN. 
DECmate then displays the List Processing Start Menu (discussed later in 
this chapter). After you have run List Processing, DECmate prints the 
results. 


NOTE: The printed results are not saved as a document. Put the result in a 
document if you want to use them again. 
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D — Merge List with a Form and Put Result into a Document. If you 
select D to send the output to a document, DECmate prompts you for the 
name of the list document, selection specification, and the form document. 
Type in the document names or numbers. 


DECmate then asks for the name of the document to receive the output. If 
you type the name of a document that does not exist, DECmate creates it — 
the name you type becomes that document’s name. 


If you specify a document that already exists, DECmate shows you the 
Document Modified display. See Figure 7. This display asks what you want 
to do with the text already in that document. You have three options to 
choose from. 


7/27/82 Mon 10:52: 


How would you like the document modified? 


‘Add text to the ta 


_ Type the letter and press RE 


OR Press Gold MENU for the Menu. 


Figure 7 Document Modified Display 


Type T or B and press RETURN to add the new List Processing output to 
the top or bottom of the document. DECmate saves the old text when you 
add the new text. 


Type O and press RETURN to overwrite the existing document. Over- 
writing destroys any text already in the document. However, if List Process- 
ing selects no records, no text is added onto the document. Thus the old 
document remains the same. 
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You can also press Gold MENU from the Document Modified display. This 
returns you to the point where DECmate asked for the output document 
name. You can then name a different document to be the output document. 


The List Processing Start Menu 


After you select the P or D option, DECmate displays the List Processing 
Start Menu (see Figure 8). The top lines show the list, specification, and 
form documents you chose. The menu also displays three final options: FR, 
TO, and GO. 


a from list d 
lection speci 


ed record 


Figure 8 The List Processing Start Menu 


FR and TO Options. Use these options when you want to process part of a 
list. For instance, if you set FR 15 and TO 22, then DECmate processes only 
the 15th through 22nd records of the list document. For DECmate to use a 
record, the record must be in this range and it must pass the tests in the 
selection specification. 
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To change either setting: 


e Type the two-letter code (FR or TO). 
e Press the space bar. 

e Type the new value of that setting. 
e Press RETURN. 


The List Processing Start Menu now shows the new value of that setting. 


Like the Print Menu, whenever you use the List Processing Start Menu, the 
FR and TO settings are reset to: 


TO 0 continues List Processing to the end of the list document. 
FR and TO can be set to any value between 0 and 999. 


GO Option. The GO option begins List Processing. Type GO and then 
press RETURN when you are satisfied with the FR and TO settings. 


While List Processing is running, you cannot use your terminal for other 
operations. Various displays scroll across your screen. These displays are 
explained below. 


As DECmate list processes each new record, it displays the number of the 


record being processed. For example: 


Record being Processed: i 


Whether DECmate sends the output to a document or to a printer, you see 
the output roll up your screen as it is produced. When DECmate sends the 
output to the printer, you see text on the screen before it appears at the 
printer a few seconds later. 


When List Processing is finished, you see a display like this: 


Records selected: 2 


Records Processed: 5S 


Press Gold MENU to recall the Main Menu 
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The number on the first line is the number of records DECmate merged 
with the form. The number on the second line is the number of records 
DECmate looked at (depending on the FR and TO settings). By comparing 
these numbers, you can determine how many records were skipped because 
they did not satisfy the selection specification. 


When you press Gold MENU, you can use your terminal for normal word 
processing once again. 


lf There Is No Output 


Sometimes the FR and TO settings and the selection specification are so 
restrictive that no records are processed. Other times you may have typed 
the selection specification incorrectly. When List Processing is finished, you 
see a display like this: 


Records selected: QO 


Records processed: 5 


Press Gold MENU to recall the Main Menu 


In this case, List Processing has no output. If this occurs, refer to the sec- 
tion, If List Processing Fails, near the end of this chapter. 
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Exercise 4: Running List Processing 


In this exercise, you will combine the documents you created in Chapter 3 
to run List Processing. Use the same diskette that stores the documents. If 
you have not already done so, turn back to Chapter 3 to complete Exercises 
1, 2, and 3. 


So far, you have created a list document (Customer List Document), a form 
document (Form Letter), and a selection specification document (Spec). 


Run List Processing and Print the Result 


Now that all your documents are ready, you can run List Processing. The P 
option will print the form letters immediately, and will not save the results 
in a document. Follow these steps to answer the menus and prompts: 


1 From the Main Menu, type LP and press RETURN. The List 
Processing Menu displays. 


2 Type P and press RETURN to send output to the printer. 


3 The system asks you for the name of the list document you want 
to use. Type the name or number of your list document. Press 
RETURN. 


4 The system asks you for the name of the selection specification doc- 
ument you want to use. Type the name or number of your selection 
specification. Press RETURN. 


5 The system asks you for the name of the form document you want 
to use. Type the name or number of your form document. Press 


RETURN. 


6 The form document’s print menu displays. Examine the Print Menu 
settings. Make any changes you think appropriate, type YES or 
OK, and then press RETURN. 


7 The List Processing Start Menu displays. Type GO and then press 
RETURN. 


33 


Running List Processing 


The selection specification appears briefly in the upper-left corner of the 
screen. It is replaced by a Record Being Processed message that continually 
updates. The output from List Processing begins rolling up the screen. 
Slightly later it prints. When all records have been processed and printed, 
the Records Processed /Selected message appears. 


Study your output. Note that List Processing has replaced all the fields in 
the form document — <title>, <last>, <:limit>, and so on — with infor- 
mation from your mailing list. Note also that List Processing selected only 
three of the four records in your mailing list. Mr. Lincoln’s record was not 
processed into a form letter, because your specification called for a mini- 
mum <:limit> of 25, and Mr. Lincoln’s <:limit> is 0. 


Run List Processing and Store the Results in a Document 


In this exercise, you will save the List Processing results as a document on 
your diskette. You will then print the results from the Main Menu. 


1 Type LP from the Main Menu. The List Processing Menu displays. 
2 Type D and press RETURN to send output to a document. 


3 The system asks you for the name of the list document you want to 


use. Type the name or number of your list document and press 
RETURN. 


4 The system asks you for the name of the selection specification doc- 
ument you want to use. Type the name or number of your selection 
specification and press RETURN. 


5 The system asks you for the name of the form document you want 
to use. Type the name or number of your form document and press 
RETURN. 


6 The Document Modified Menu displays. Type Result for the name 
of your output document and press RETURN. 


7 The List Processing Start Menu displays. Type GO and press 
RETURN to begin List Processing. 


8 Once you return to the Main Menu again, print your output docu- 
ment called Result. 
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lf List Processing Fails 


If you run List Processing and get no results — no records are selected and, 
therefore, no form letters are produced — it is usually because of some 
minor flaw in one of your three documents. This flaw could be an extra 
space or other detail easily overlooked. Make sure: 


e You typed the list document, form document, and selection specifica- 
tion exactly as indicated in Exercises 1, 2, and 3 


e You did not add extra spaces, lines, or page-end marks that changed 
the format of the output 


e You followed the List Processing procedure in this exercise exactly 
and selected the proper options 


If these checks still produce no results, make sure that your DECmate sys- 
tem is functioning properly by trying other word processing functions. 


Then, if necessary, re-enter new, smaller versions of a list document, form 
document, and selection specification and run List Processing with these. 


To Stop List Processing 


To stop List Processing, press Gold HALT. After a few seconds delay, pro- 
cessing stops. Then DECmate displays the total number of records selected 
and processed. If you chose the P option, DECmate prints all records 
selected up to the point you pressed Gold HALT. 


Return to the Main Menu by pressing Gold MENU. You cannot finish the 
operation you canceled. If you decide to do List Processing again you must 
start from the beginning. However, you can set FR to start where you 
stopped the previous time. 


Stopping the Printer 


List Processing uses your terminal while it is running. If you choose the P 
(print output) option, you cannot stop the printer while it prints the list- 
processed output (except by pressing the Pause button, if your printer has 
one). The Stop Printer Menu is not available to you. However, you can set 
the printer to stop from the Print Menu. 
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Suppose you are printing on single sheets of paper, such as letterheads. To 
stop at the top of every new page so you can insert a new piece of paper, set 
SE to YES when the Print Menu is displayed. You can also set SE FIRST at 
the Print Menu to stop the printer at the top of the first page. 


When DECmate is ready to print the first list processed page, the display on 
the screen freezes. However, the beeper does not sound. When you notice the 
display is frozen, insert a sheet of paper into the printer (or take other 
appropriate action) and then type R. Do not press RETURN as you would 
when using the Stop Printer Menu. 


Each time the display stops, DECmate is waiting for a command to resume 
printing. You have two choices: 


e Insert another sheet of paper and type R to resume printing — the 
usual response. 


e Type N to advance the paper in the printer one page. 


If processing is still going on when the screen freezes, you can also press 
Gold HALT to stop processing, as described in the previous section. 


Remember, the printing lags behind what you see on the screen. When you 
see the message DOCUMENT FILING BEING COMPLETED, there are still 
a few pages to be printed. Continue to feed sheets of paper and type R until 
you see the message giving the number of records selected and processed. 
Press Gold MENU to recall the Main Menu. 


Processing Large Lists 


When running List Processing, the FR and TO settings can only be set to 
999. For records numbered 1000 and up, you must set FR to 999 and TO to 
0. This processes the list from 999 to the end of the list. 


If there are more than 2000 records in the list document, the numbers that 
display on the screen when List Processing is running do not reflect the true 
count of the records processed. The message showing the number of records 
selected is also not correct. However, list processed output is still correct. 


36 


q 


q 


yyrdyrdprygiyrdy 


Running List Processing 


Testing a Selection Specification 


T — Testing a Selection Specification for Errors 


Your third choice at the List Processing Menu is to test your specification. 


When you run List Processing, DECmate automatically tests your selection 
specification to make sure it is valid. This test occurs with whatever option 
in the List Processing Menu you choose. 


The T (Test) option in the List Processing Menu lets you test a selection 
specification without running List Processing. Select this option if you are 
not sure you have typed the specification properly. If there are errors in the 
specification, you get the error message described below. If there are no 
errors, DECmate tells you so, using a display such as this: 


if <overdues+=<2> or more 
then Process record 


No errors in specification 


If the selection specification contains an error, DECmate marks the first 
error with the symbol *. For example: 


if <overdue?=<2? or more 
then Process reca 


FRROR-- specification not understood starting at this Point. 


If the selection specification contains a numeric field value with an error, | 
you may get the message: 


ERROR-- invalid number specified 


Note the location of the error, and press Gold MENU to recall the Main 
Menu. Edit the selection specification document to correct the error. 


If the selection specification does not contain any errors, DECmate processes 
the list. 


37 


o 


Advanced List Processing 


This chapter discusses further details about creating documents and run- 
ning List Processing. 


The List Document 


This section includes shortcuts and helpful hints you can use in creating list 
documents. 


Invisible Hyphens 


Use invisible hyphens in field values with long words. For example: 


¢name>International Brotherhood of Electricians 


<? 


Insert invisible hyphens: 


A 


€name>In ter na tion al Bro ther hood of Elec tri cians 
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Comments 


Use comments in your list document to help others who might use your list. 
Comments are optional text used to describe the information in the list doc- 
ument: what the fields are, and the correct form of each field name. Remem- 
ber to keep your comments short, because they do use up disk space. 


Here is an example of useful comments: 


comment 
This is the customer mailing list. Each record has fields 
etitle>, ¢firsti» and <last? to record the Person’s names and 


address> for complete mailing address: <:owed? is the amount 
they owe us at the first of the month, 


4 Press GOLD Command 
Type Comment and press RETURN 


Type the comment as needed 


mh j@W ND 


Press GOLD Command to end control 


Cut and Pasie 


Use cut-and-paste to cut a blank record into the paste area. Press the 
PASTE key to insert the blank record into your list document. Then fill in 
the empty fields. 


To delete a record, use the cut operation. 


To move a record to a different place in the same list document, cut and 
paste it. CUT the record out of the document, position the cursor where you 
want to put the record, and press PASTE. 


For more details on cut-and-paste, see the User’s Guide (AA—N563A-—TA). 
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Abbreviation and Library Documenis 


If you use List Processing often, you should use an abbreviation or library 
document to store a blank record. 


For more information on the abbreviation and library functions, refer to the 
User’s Guide. 


Printing a List Document 


You can print your list document, since the list document is an ordinary 
word processing document. You can include highlighting, rulers, print con- 
trol commands, and invisible characters. They work in the usual way when 
printing a list document. 


Using Empty and Missing Fields 


Empty and missing fields contain no text. When you type a list document, 
you may not have all the information you need. For instance, you may not 
know someone’s first name or zip code. You can leave out some field names 
and values in a record. DECmate performs List Processing on the informa- 
tion available. 


In a customer mailing list, suppose you did not know Mr. Filmore’s first 
name. You could include the <first> field, and press RETURN. This is an 
empty field; it has no field value: 


<titlesMr,. 

Cfirst> 

<last>Filmore 

<address+d407 Memorial Drive 
Cambridge, Mass, 02140 


ie 
i? 


Or you could leave out the <first> field entirely. This is a missing field: 


<title>Mr. 

<last>Filmore 

€<address+407 Memorial Drive 
Cambridge,» Mass. 02140 

<> 
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If a form document includes the field name <first>, DECmate looks in the 
list document for that field. If the field is empty or missing, then DECmate 
inserts no text in the form document. For example: 


Mrs Filmore 
407 Memorial Drive 
Cambridges Mass. 02140 


Dear Mr. Filmore: 


All of us at the Southport Book Store would like to 
thank yous + for your Patronage in the Past yveare We s4-. 


Note that on the top line, there is an extra space between Mr. and Filmore. 
These spaces were supposed to precede and follow the first name. “Dear Mr. 
Filmore:” is all right, because the form did not call for the first name. But 
in the body, the writer meant to call Mr. Filmore by his first name. Since 
his record in the list document does not have any text for <first>, 
DECmate again inserts nothing. Here, the absence is noticeable. 


Be careful in creating a selection specification that might test an empty or 
missing field. Suppose your records have a field <credit> that contains a 
GOOD or BAD value. One selection specification might select the GOOD 
records, and another select the BAD records. A record where the <credit> 
field is empty or missing is not selected by either specification. 


Using Numeric Fields 


Use numeric fields in Math. You can purchase and activate the Math fea- 
ture to use with List Processing. Once Math is activated, it works during 
both editing and List Processing. If you set up your list document with 
appropriate numeric fields, Math allows DECmate to perform calculations 
on the field values. 


Note that you do not need Math to create and use numeric fields. List Pro- 
cessing can treat numbers as simple characters. You need Math if you want 
to perform calculations. 


For more information on Math, see Using Math (AA—N186A-TA). 


Any time that you include numbers in the field value, consider making that 
field a numeric field. A numeric field name is any field name that begins 
with a colon (:), such as <:cost>. 


42 


q 


2.48 74 


| 


?oa31d41713)71 71 


7 


q 


Advanced List Processing 


The rules for creating a numeric field are: 


e Each numeric field must have no more than 13 valid characters. 


e Numeric field values with decimal points must have no more than 
six characters after the decimal point. For example: 13.365785. 


e Some symbols in the numeric field value are valid only in certain 
positions: 


The characters $ * + () can appear no more than once, if they 
appear. 


The characters $ * + (can appear only at the beginning, if they 
appear. 


The character ) can appear only at the end, if it appears. 

The + sign must come first, if there is one. 

The — sign must be either first or last, if it appears. 

The $ sign must come before the * and after the + or — signs. 
Each pair of parentheses must enclose numbers. 


The characters ( ) and the — sign cannot appear in the same field 
value. 


There must be no empty pairs of parentheses. 


Commas serve as numeric separators. 


The following are examples of valid numeric fields, and their numeric 


values: 

Numeric Field Numeric Value 
<:cost>123.50 123.5 
<:cost> 123.50 123.5 
<:cost> + 123.50 123.5 
<:cost>$123.50 123.5 
<:cost>**123.50 123.5 
<:cost>—123.50 —123.5 
<:cost>(123.50) —123.5 
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You can use a maximum of 13 digits in a numeric field value, with a maxi- 
mum of six digits to the right of the decimal point. If you must include more 
than 13 digits in a field value, then do not make the field name a numeric 
field name. 


The following are examples of invalid numeric values: 


invalid Field Value Reason 


<:cost>AB 123.5 Letter before number 
<:cost> +— 123.5 Signs contradict 
<:cost>123.5) Missing parenthesis 
<:cost>123,456,789,123.456 Too many digits 
<:cost>123,456.7891234 Too many digits after 


decimal point 


The Form Document 


Different Types of Form Documenis 


Continuous-Form Envelopes. Envelopes attached to continuous-form 
paper allow you to insert them into your printer. Create the following form 
document for List Processing envelopes to accompany your form letters. 


<title? <first? ¢last> 
address> 


Put your address in the corner if necessary. 


You must adjust your form’s print settings in the Print Menu when you run 
List Processing. You will have to experiment, since envelopes can come in 
any size. 
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In DECmate Word Processing, 6 lines equal 1 inch. Try setting your top 
margin (TM) to 8 lines, your bottom margin (BM) to 0 lines, and your page 
size (PS) to 24. The page size causes DECmate to treat each envelope as a 
new page, to advance to the next envelope. The top margin starts the print- 
ing in the middle of the envelope face. 


For more information on using the print settings, refer to the DEC mate II 
User’s Guide (AA—N563A-TA). 


Individual Envelopes. Create the form shown in the last example for List 
Processing individual envelopes. Set the form’s print setting to stop before 
each page (SE YES). Remove the tractor or sheet feeder and hand-feed the 
envelopes into the printer. Press R (Resume) at the Main Menu to start 
each printing sequence. 


For more information on using the SE setting, refer to the DECmate II 
User’s Guide (AA—N563A-TA). 


Labels. Create the following or a similar form document to list process 
mailing labels. 


<title> ¢first?> ¢last? 
address> 


You must adjust your form’s print settings in the Print Menu when you run 
List Processing. You will have to experiment since labels can come in any 
size. 


In DECmate Word Processing, 6 lines equal 1 inch. Try setting your top 
margin (TM) to 2 lines, and your page size (PS) to equal the size of the 
label. The page size causes DECmate to treat each label as a new page, to 
advance to the next label. The top margin starts the printing at the top of 
the label. 


For more information on using the print settings, refer to the DECmate I 
User’s Guide (AA—N563A-TA). You can also process labels with the form 
shown in the next section, Forms with Multiple Columns. 
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Forms with Multiple Columns. You can process forms that have multiple 
columns in two ways: 


With a letter quality printer, you can use the multicolumn printing feature. 
For more information, see the User’s Guide. 


With an automatic sheet feeder, draft printer, or letter quality printer, you 
can create the following form: 


first field? <second field? <2} <¢<first field? <second field? <3 


first field? <second field? <2 <first field? ¢<second field? <¢3 


DECmate prints the first record on the left, followed by the second record. 
The third record goes on the next line left, and so on. You can use as many 
columns as the paper allows. 


For more information on using multicolumn printing, refer to the 
DECmate II User’s Guide (AA—N563A-TA). 


Tables 


In List Processing it is possible to produce a table of information by using a 
form document that does not end with a NEW PAGE mark. 


For example, if the bookstore in the examples merged its customer mailing 
list with the following form document, it would get a directory of its 
customers: 


The following is a list of our Massachusetts customers as of 
January l, 1982, 

Lincolns Abraham 

1865 Gettysburg St, 

Lexington» Mass 02540 


Young+ Brigham 


Seven Sisters Ave, 
Brocktons Mass 02444 
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The following sections discuss details about creating a table with List 
aia Processing. 


pen Including Leaders and Trailers. When making a table or directory, you 
may want to put some information before or after the list. In a telephone 
al directory, you might want a title and column headings to precede the list 


of people and telephone numbers. You might want to include dialing 
— instructions. 


_ You produce leaders and trailers by putting the commands <!S> for start 
and <!E> for end in the form document. 


= The command <!S> in a form document marks the beginning of the repeti- 
= tive area. Text before <!S> in the form document is produced before List 

Processing of records begins, and is produced only once. This text is the 

leader. 

The command <!E> in a form document marks the end of the repetitive 
vo area. Text after <!E> is produced after all records are processed, and is pro- 
= duced only once. This text is the trailer. 

A form document can have only one <!S> and only one <!E> command. 
ae The <!S> command must precede the <!E> command. 

7 If you are using Math, you can include numeric field names, such as 
<:total>, in the trailer. DECmate does the necessary calculations and 
- substitutes the resulting value for the numeric field name. For more 


information on using numeric fields in the trailer, see Using Math 
o— (AA—N186A-TA). 


omen If you have a form document with a leader and a trailer: 


~~ 1 DECmate prints the text in the leader. When it finds the <!S> 
command, List Processing begins. The start of the repetitive area is 
the <!S> command. 


- 2 DECmate processes the first record from the list document and 
then finds an <!E> command in the form document. Since there 

a are still records to be processed, List Processing does not stop. 

o 3 DECmate returns to the start of the repetitive area and goes to the 

sa next record in the list document. DECmate then repeats the process 
in step 2. 

— 


47 


Advanced List Processing 


4 When DECmate processes the last record and finds the <!E> com- 
mand, the repetitive processing ends. 


5 DECmate prints the text in the trailer, and the job is complete. 
The general form of a form document with <!S> and <!E> commands is: 


leader 
¢ 19> 


The body of repetitive informations brought over from the list 
document 


{leo 


trailer 


If you leave out the <!S> command, there is no leader; the repetitive area 
begins at the top of the document. DECmate returns to the top of the form 
document for every new record it processes. If you leave out the <!E> com- 
mand, there is no trailer; the repetitive area ends at the bottom of the 
document. If you leave out both commands, there is no leader or trailer. 
DECmate makes one copy of the entire form document for each record it 
processes. An example of a table with repetitive information follows. 


Here is a form document for a table of parts: 


PARTS LIST 
for Project X 


Part Part Name Cost 

Number  --------- ---~ 

<!1S> 

<Part#> <name> f2costrc le? 


Parts can be ordered from Stockroom 5, 


48 


4 


4 


y 


yyqadd4) 


7 
o— 
roa 


Advanced List Processing 


This form has a leader and a trailer. The repetitive area, between <!S> 
and <!E>, consists of one line. It tells DECmate to: retrieve the value of 
<part >, advance to the tab position, retrieve the value of <name>, 
advance another tab position, and retrieve the value of <:cost> for each 
record. 


Here is a list document for a parts list: 


€Part#>80-0030 
<namerLockwasher 
€scost?0,015 

«> 
<Part#-80-0040 
<name>Diode 
€:co0st+0,02 

<> 


<Part#2:80-0235 
name >Glue 
<tcosteexpendable 


<> 
Here is the output: 


PARTS LIST 
for Project X 


Part Part Name Cost 
Number --------- ---- 
80-0030 LocKwasher 0,015 
80-0040 Diode 0,02 
80-0235 Glue 0,01 


Parts can be ordered from StocKroom 5, 


Spacing in Leaders and Trailers 


Double Spacing. When the <!E> is at the end of a line in the form doc- 
ument, the table is single-spaced. If you moved the <!E> command to the 
start of the next line, there would be an extra return inside the repetitive 
area that would double space the table, since every record would be both 
preceded and followed by a return. 
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Tab Positions. The following form document inserts a hard return at the 
end of every list processed record, instead of the start. The spacing of the 
<!S> command has been adjusted so that this form gives the same output 
as the previous example. 


ee Tea------ C ---------- Tween eee ee eee ee ee R 
PARTS LIST 
for ProJect X 


Part Part Name Cost 

Number --------- ---- 

{!So<part#:s <name> {rcost> 
<lE> 


Parts can be ordered from StockKroom 5, 


Notice that putting <!S> at the start of the line has pushed the field names 


out to the next tab position. In the form document, they no longer line up 
with the headings. 


Whether the field names align with the tab position does not matter. 
DECmate does not print the <!S> command, but instead goes to the list 
document for records to process. Once the field values are inserted, the col- 
umns line up correctly. 


Changing Rulers in Repetitive Areas. Sometimes you may want to 
change the ruler settings in the repetitive area. You might want to put 
<part > on the line above <name>, or align <:cost> fields on the decimal 
point. For example: 


be See ses Leese SSS So2Ssen T-------------- R Ruler A 
PARTS LIST 
for ProJect xX 


Part Part Name Cost 

Number  --------- ---- 

{!9> 

{Part#-> 

L------- T wn ee eee ee cer rrr ere Q rtm error ree R Ruler B 
cname > frcastec le? 


Parts can be ordered from Stockroom 5, 
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In this example: 


4 Ruler A formats the title, column heads, and <!S> command. It 
also formats the field <part > from the first record. 


2 Ruler B formats the fields <name> and <:cost>. 


3 DECmate finds the <!E> command and returns to the start of the 
repetitive area. 


4 DECmate still uses Ruler B to process the second record and format 
the field <part > as well as <name> and <:cost>. Ruler A is 
ignored because Ruler B overrides it. 


Sometimes, as in the example above, the second ruler works just as well on 
the text inserted after the <!S> command. To be sure, test the output docu- 
ment by printing it. 


If you change rulers in the repetitive area, then you may need to put a ruler 
directly following <!S> in the form document. 


fi cree ee Ph pp dials CO 2e52e2=5e5 T-------------- R Ruler A 
PARTS LIST 
for Project xX 


Part Part Name Cost 

Number  --------- --=- 

«19> 

L----------------------------------- == R Ruler B 

{Part#> 

L-------- T -------------------- gee eee conn R Ruler C 
“name > frcostec lE? 


Parts can be ordered from Stockroom 5. 


DECmate uses the rulers in this way: 


4 Ruler A formats the title, the column heads, and the <!S> 
command. 


2 Ruler B formats the field <part#>. 


3 Ruler C formats the fields <name> and <:cost>. 


of 
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4 DECmate finds the <!E> command and returns to the start of the 
repetitve area. 


5 DECmate processes the second record and formats the field 
<part#> according to Ruler B, then the fields <name> and 
<:cost> according to Ruler C. 


DECmate continues processing records and repeats steps 2, 3, and 4 until 
all records are processed. Then it prints the trailer. 


Advancing to the Next Record. You can control the format of an output 
document by including a <> command in your form document. 


If DECmate finds an <!E> command during List Processing, it returns to 
the start of the repetitive area. However, if DECmate finds a <> command, 
it continues forward in the form document and processes the next record. 


DECmate advances to the next record when: 1) it finds <!E> in the form 

document, or 2) it finds the bottom of the form document. It also advances 
immediately to the next record when it finds the <> command in a form 

document. 


(Do not confuse the <> command in the form document with the diamond 
<> in the list document. The diamond <> in the list document marks the 
end of a record. The <> command in a form document makes DECmate go 
back to the list document to get the next record for List Processing.) 


Study the following form document. This form document has almost the 
same output as the previous examples: 


a T------- C ---------- T---- eee ee ee ee ee FR 
PARTS LIST 
for ProJect XK 


Part Part Name Cost 

Number --------- ---- 

{19>} 

CPart#> <name> frcosts<> 
€Part#> <name> f2cost3< > 
{Part#> <name> Lrcoste< !E> 


Parts can be ordered from Stockroom 5, 


52 


q 


dof 


jody 7173 3'4 


Aavanced List Processing 


The repetitive area of this form handles three records from the list docu- 
ment. After the <!S> command is a hard return that produces a blank line. 
DECmate then writes the part number, name, and cost. The diamond <> 
makes DECmate advance to the next record. The next line in the form does 
the same, and advances to the one after that. The <!E> returns DECmate 
to the <!S> at the top of the document because there are still records to 
process. The result looks like this: 


PARTS LIST 
for Project xX 


Part Part Name Cost 
Number  --------- ---- 
80-0030 LocKwasher O,015 
BO-0040 Diode 0,02 
80-0235 Glue 0,01 
80-0451 Hex Screw 0,03 
80-0477 Hex Nut 0,017 


Parts can be ordered from Stockroom 5. 


This form accepts records in groups of three. If the number of records in the 
list document is not a multiple of three, this form produces one or two extra 
blank lines when it runs out of records. 


Pressing RETURN after the <!S> command makes DECmate put a blank 
line before the first record and after every third record in the output docu- 
ment. This makes the table easier to read. 


Skipping the Next Record. You can make DECmate skip a record in the 
list document by including a <> command. Be sure you use only as many 
<> commands in the form document as you need. 
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Here is a form document that skips every other record from the list 
document: 


PARTS LIST 
for ProJect X 


Part Part Name Cost 

Number --------- —— 

< 19> 

<Part#> <name> f2costse4 ec lE> 


Parts can be ordered from Stockroom 5, 


Notice the <> command between <:cost> and the <!E> command. This 
command makes DECmate go to the next record. The <!E> returns 
DECmate to the start of the repetitive area and advances to the next record 
again. So one record is never processed. As a result, only every second rec- 
ord is processed. 


(Do not confuse the <> command in the form document with the diamond 
<> in the list document. The diamond <> in the list document marks the 
end of a record.) 


NOTE: If you create a form document that skips records, DECmate may 
select a record but not process it (a skipped record). In this case, the number 
of records processed does not match the number of records in the output. 


Copying Lists. You can make DECmate produce a list document as out- 
put by using the <!R> command. 


The command <!R> copies the characters from the start of the first field 
through the end of the record. The <!R> command does not copy the spaces 
between records; therefore, in the form document, you should follow <!R> 
with two hard returns to separate the records. The output document is also 
a new list document. 
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Include comments for the new list document as a leader in the form docu- 
ment. Here is an example of a form document that produces a list document 
as output. The command <!R> inserts in the list processed output an exact 
copy of each record: 


This file contains active customer accounts, 


41S> 
<IR? 


The <!R> command is useful in producing sublists from a larger list. Sub- 
lists are discussed in greater detail in the next section. 


Printing Sublists. Chapter 3 shows how a document called the selection 
specification lets you select records from the list document. Instead of pro- 
cessing each record in sequence, DECmate processes only selected records. 
You might use a form document such as the one above to make a copy of 
the list. If you select only certain records, List Processing copies only those 
records. The result: a list document containing a portion of the original list. 


For instance, suppose your business has gained many new customers. The 
mailing list became larger as you added names to it. Now the list is so large 
that you want to divide it into sublists. Make two selection specification 
documents. One might select in-state customers, while the other selected 
out-of-state customers. Now, using List Processing twice, you could make 
two sublists. Together, they would contain all the records from the original 
large list. 


Printing Angle Brackets. Whenever DECmate finds the left angle bracket 
< in a form document, it interprets the < and the characters that follow it 
either as a field name or one of the commands presented in this chapter. 


To put a < character in your output document, you must put two << char- 
acters in the form document. When DECmate finds two left angle brackets 
together during List Processing, it does not look for a field name or a com- 
mand after the pair of left angle brackets. Instead, it produces one left angle 
bracket, <. 
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You can put the right angle bracket > in the output document by typing it 
in the form document. The right angle bracket has no special meaning un- 
less it follows a left angle bracket <. The left angle bracket begins a field 
name or command. 


Suppose you have this record in a list document: 


<namesArthur Mitchell 

<Position>Sales Manager, Eastern Region 
<location+Eastern Region Sales Office 
<mail address?Boston RYV3 
<telerphone+838-4853 

a? 


The following form document produces a new list document. In the new list 
document, the old list document’s fields have shorter names. 


ccnaz<name > 

é<locet location? 
<<Phonerzttelerhone > 
<<} 


For each record, this form document makes DECmate produce the charac- 


ters <na>. DECmate then retrieves the value of the record’s <name> field. 


Then DECmate produces the characters <loc> followed by the value of the 
field <location>, and so on. The last line in the form document outputs a 
diamond. The result is: 


fnatzArthur Mitchell 

{loctEastern Region Sales Office 
<Phone?+838-d4853 

i} 

Summary of Commands. 


<!S> Start the repetitive area here, not at the top of the form document. 
(Preceding text is a leader.) 


<!E> End the repetitive area here, not at the bottom of the form docu- 
ment. (Following text is a trailer.) 


<!R> Copy the record from the list document into the output document. 
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<> Advance to the next record in the list document. 


<< Produce a single left angle bracket < character at this point. 


The Selection Specification Document 


The first part of this section lists different types of selection specification 
documents you can create. Use these variations for processing lists with 
more precision. The second part deals with testing a selection specification. 


Acceptable Variations for Specifications 


Using Or. You can use the word or to test the same field for several differ- 
ent values. 


if <state?s=New Hampshire 
or=N.H,. 
or=NH 

then Process record 


This example selects records referring to New Hampshire, accepting three 
values for the field <state>. Note that the second and third lines are 
indented for easier reading. 


You can include or omit spaces after the word or. 


if <statez=New Hampshire 
or=N.H,. 
or =NH 

then Process record 


Remember that each test in a selection specification must be on a separate 
line. 


Using And. You can combine several tests with the word and so you can 
test more than one field at a time. DECmate selects a record only if it satis- 
fies all the tests you give. 


if <city?=Hudson 

and <states=New Hampshire 
or=N.H, 
or=NH 

then Process record 
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This example selects records referring to residents of Hudson, New 
Hampshire. It omits residents of any other state. Three acceptable values 
are given for <state>. Note that this example contains both and and or 
specifications. 


Rejecting Some Records. You can reject some of the records, even if 
they have passed all the tests up to now by starting a line with the words 
but not if. 


if <city?=Hudson 
and <state>=New Hampshire 
or=N.H. 
or=NH 
but not if <credit?e=bad 
then Process record 


Adding this conditional leaves out certain records even though they pertain 
to residents of Hudson, New Hampshire. 


Using More than One Sentence. Selection specifications can have more 
than one sentence. A sentence is a list of acceptable values in a specification 
that begins with if and ends with then process record. Link these sentences 
together with the word or. 


Here is example of a selection specification with several sentences. This 
example has an extra line between sentences to show the proper grouping of 
ideas. 


if <state*=Maine 
then process record first sentence 


or if <state?=Massachusetts 
and “<county?=Middlesex second sentence 
then Process record 


or if ¢<states=New Hampshire 

and <county?=Hillsborough 
or =Rockingham third sentence 
or =Strafford 

then Process record 


DECmate processes records that satisfy either test. This selection specifica- 
tion selects records that pertain to Maine and counties in two other states. 
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= Advanced List Processing 
Broader Specifications 
= Up to now, you have seen tests that try to match values character-for- 
: | character. You can test the value of a field other than a character-for- 
= character exact match. You can match: 
a e Empty or missing fields 
e §6Fields that match a partial value by using wildcards 
i e Number values 
ail ° ° ° 
The following sections discuss these tests. 
se Testing for Empty or Missing Fields. You can write a selection specifica- 
= tion to select records in which a certain field is empty. 


If the phrase after the equal sign has no text (only a hard return), then 
sae DECmate checks to see if the specified field value has no text — that is, to 
see if it is empty. 


if <zip-?= 

— then Process record 

fmm This selection specification selects records with an empty <zip> field. 
DECmate leaves that field blank in the output document. In this way, you 

7 can keep track of empty fields and try to update your list document. 

_ In the example just discussed, records with a missing <zip> field are not 
selected. That is, if DECmate does not find a <zip> field name in that 

_ record, then it does not process that record. Instead, it goes on to the next 
record. 


Suppose your records have a field <hourly> that contains YES or NO 
value. And suppose you have one selection specification that selects the YES 


records, and another that selects the NO records. You could also write a 
third specification that selects records with the <hourly> field empty. A 
aaa ; bt cat ; 
record where the <hourly> field is missing is not selected by any of these 
= specifications. 
Using the methods discussed so far, you cannot select records with missing 
= fields. To select records with missing fields, you must use a selection specifi- 
caton that has a wildcard. 
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Using Wildcards. In the selection specifications previously discussed, a 
phrase must match character for character. However, there are two special 
characters that can match characters different than those in the field value. 
Wildcards let you write more flexible tests. The two types of wildcards 
DECmate recognizes are questions marks <?> and asterisks <*>. 
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To look for any character in the field value, type <?> in the phrase. 
For example: 


if <credit?=<¢?> 
then Process record 


This specification tells DECmate to select records whose <credit> 
fields contain exactly one character. It does not matter what charac- 
ter. DECmate ignores records whose <credit> fields are empty, 
missing, or have more than one character. 


You can combine the <?> wildcard with text. When you do, 
DECmate looks for specific characters where you used text, and any 
character where you used <?>. For example: 


if <model#>=Ri 73-1547? 
then Process record 


DECmate looks in the field <model#> for a capital R, any charac- 
ter, a hyphen, a one, a five, and then any character, in that order. It 
selects only those records that match this form. RA—156 and R3-15B 
are two valid model numbers. 


For Any Number of Characters 


To look for a particular number of any characters, type one question 
mark for each character. For example: 

if <towns=<PPPPP boro 

then Process record 


The wildcard in this example makes DECmate look for any five 
characters at the start of the field value. Fields called <town> with 
values Northboro and Southboro match this test. Westboro (only 
four characters) does not. 
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To look for any number of any characters, including none, use the 
asterisk wildcard <*>. 


if <towns=<#>boro 
then Process record 


The values Northboro, Southboro, Eastboro, and Westboro all match. 
Any field value matches as long as the last four characters are boro. 
A field containing only the four characters boro would match. Miss- 
ing and empty fields do not match. 


NOTE: You cannot use more than two <*> wildcards on the same 
line. 


The following specification selects any record where the <name> 
field value contains Jones, regardless of what characters precede or 
follow it: 


if ¢names=<#¥>Jonesi*> 
then Process record 


Records with <name> fields containing J.P. Jones, Sr., John Paul 
Jones, Jr., Mary Jones, or just plain Jones would all match this test. 


if <zZipr=<i#> 
then Process record 


This selects any record where there is a <zip> field. This includes 
empty <zip> fields. But, records with a missing <zip> field are not 
processed. 


Here is an example of selecting a record with a missing field: 


if <town?s=Northboro 
but not if <zips=i#> 
then Process record 


This selection specification is the opposite of the previous one. It 
selects only those records for which the <zip> field is missing. 
DECmate cannot read a selection specification that begins with but 
not if. So you must have a selection phrase before but not if that 
relates to all the records you want to test. 
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Using Number Values. There are three ways to use numbers in a selec- 
tion specification: 


e You can test numbers numerically. If the field name is numeric, 
such as <:cost>, then the selection specification tests for the 
numeric value of the field value. 


e You can test numbers character for character. If the field name is 
not numeric, such as <cost>, then the selection specification tests 
the field value character for character. 


e You can test numbers by digits only. If the field name is not 
numeric, but the field value is enclosed in <angle brackets>, such 
as <cost> = <$100>, then the selection specification tests only the 
digits in the value. All other characters are ignored. 


Always use a numeric field name for fields that have a numeric field value. 
A numeric field name is any field name that begins with a colon (:), such as 
<:cost>. 


A numeric field value can contain a maximum of 13 digits, with a maxi- 
mum of 6 digits to the right of the decimal point. If you need to include 
more than 13 digits in a field value, then read the section on Testing Char- 
acter for Character, later in this chapter. 


e Testing Numerically 


When the selection specification tests a numeric field (one with a 
colon), it uses the following guidelines: 


— DECmate ignores leading zeros, leading and trailing asterisks, 
the plus sign, and the dollar sign. Thus, 10000, 010000, *10000, 
+ 10000, and $10000 are all equal. 


— DECmate recognizes parentheses or a leading or trailing minus 
sign as giving a number a negative value. Thus, (10000), —10000 
and 10000— are equal values. But these numbers have a different 
value than 10000. 


— DECmate considers decimal points when a numeric field is 
tested. Thus 10000 and 10000.00 are equal. But $10,000, 1000.0 
and 100.00 are not equal. 
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— Comma separators to the left of the decimal point position do not 
affect the value of the number. Thus 10000 and 10,000 are equal 
values. Commas to the right of the decimal point are not valid. 
Thus, DECmate does not recognize 10000.00,1 as a numeric 
value. 


— Alphabetic and other nonnumeric characters are not acceptable 
values in a numeric field. DECmate does not recognize either 
10A000 or @10000 as numbers. 


— Certain characters have a different value when part of a numeric 
field. These characters are $, *, +,-, (, and ). For a list of 
acceptable characters in a numeric field, see the section on list 
documents. 


List Processing Math only allows numeric fields to do List Process- 
ing Math. For more information on the Math feature, see Using 
Math (AA-N186A-TA). 


Testing Character for Character 


A selection specification tests a number value differently, depending 
on whether the field name is numeric or not. If a field name is non- 
numeric (no colon), the selection specification tests the field value 
character for character. 


Suppose you wanted to select records referring to projects that cost 
$10,000. If you write: 


if ¢cost?=$10,000 
then process record 


DECmate looks for a match to $10,000 character for character. It 
does not select records where you left out the dollar sign or the 
comma. 


Testing Digits Only 


Another way to test the value of a field containing numbers is to 
enclose the number you are looking for in <angle brackets>. This 
makes DECmate consider only the digits in the field and ignore the 
dollar signs, commas, decimal points, minus signs, and so on. 
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Use this method to test long numbers, up to 30 digits. (Remember, a 
numeric field can only have a numeric value of 13 digits.) 


if ~cost2=af10000> 
then Process record 


In this selection specification, the field values $10,000, $10000, 
10000, 100.00, and so on, all match. The value of the numeric part 
of all these values is 10000. 


When you use this method, DECmate also ignores the nonnumeric 
characters inside the angle brackets in the selection specification. So 
you could write: 


if <~cost+z=<$10,000>; 
then Process record 


Again, the field values $10,000, $10000, 10000, and so on, all match. 


NOTE: The above selection specification would also select records 
where <cost> was $100.00 or —10,000, since DEC mate ignores deci- 
mal points and minus signs and evaluates the field value as a num- 
ber. Whenever possible, use numeric field names to eliminate this 
problem. 


You can solve the problem of selecting records with the same digits, 
but different values, such as —10,000 and $100.00, by using numeric 
field names. For example: 

if <:costs=<10000>2 

then Process record 


NOTE: You cannot use wildcards <*> and <?> ona line where you 
are using the <angle bracket> method to test for a number. 
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Testing Numeric Ranges 


You can also test for a range of numbers using selection specifications like 
these: 


if <field name?=<number> or more 

if <field name?=<number? or less 

if <field name?=<number? through <number? 
if <field name?=tnumber> thru <number? 


These forms let you select records where the value of a field containing 
numbers is within a certain range. The last two forms have the same effect. 


NOTE: You cannot use wildcards <*> and <?> on a line where you are 
using the <angle bracket> method to test for a number or numeric range. 


Numeric Fields. If you use numeric field names, you can test for field val- 
ues within a numeric range. For example, you can select records for employ- 
ees whose salaries are in a certain range: 


if <:salary2=<10000> thru <14999> 
then Process record 


You can select customers who have owed $50 or more for at least 3 months: 


if <sbalance?=<50.,003 or more 
and <:toverduer=<3> or more 
then Process record 


Nonnumeric Fields. However, if you use a nonnumeric field name, re- 
member that the number within <angle brackets> is treated differently. 
The field value of 50.00 in the above example would have a numeric value 
of 5000, because the decimal point is ignored. If you use nonnumeric field 
names, use the following selection specification: 


if <balance?=<50? or more 
and <overdue>=<3> or more 
then Process record 
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Using Dates as Numbers. If you want to test for a field value that is a 
date, DECmate matches the date character for character. For example: 


if <date?=1/23/81 
then Process record 


This specification selects records with a <date> field with a value of 
1/23/81. 


To match for a date as a string of numbers, use the <angle bracket> 
method of testing for a number: 


if ¢date?=<1/23/81> 
then Process record 


This selection specification selects records with values such as 1/23/81 and 
1-23-81 in the date field. However, it also selects the date 12/3/81. 


To resolve this confusion, include zeros (0) where appropriate to make 
months and days two (2) digits. Then 1/23/81 becomes 01/23/81, and 
12/3/81 becomes 12/03/81. 


Testing for a Range of Dates. If you want to test for a range of dates, do 
not put them in numeric form . For example, to process all records with a 
<date> field value between July 14, 1941 and June 21, 1978, write July 14, 
1941 as 07/14/41 and June 21, 1978 as 06/21/78. 


Also, you cannot use the selection specification: 


if ¢<date?=<07/14/41> through <O06/21/78> 
then Process record 


The field <07/14/41> has a numeric value of 071441. And <06/21/78> 
has a numeric value of 062178, which is smaller than 071441. So the range 
071441 through 062178 is not valid. 


To resolve this problem, reverse the dates to type the largest value (the 
year) first. The format is: 


year /month/day 
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Use numeric field names. Include zeros (0) where appropriate to make 
months and days two (2) digits. So July 14, 1941 becomes <410714>. June 
21, 1978 becomes <780621>. The following selection specification then 
works properly: 


if <rdates=<410714> through <= 780621 > 
then Process record 


Remember, you cannot include the slash (/) character in a numeric field 
value. 


You can also resolve the problem by using a nonnumeric field name: 


if <date?=<41/07/14> through <78/06/21+> 
then Process record 
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summary of List Processing 


This chapter outlines and summarizes how to do List Processing. It isa 
review for experienced users. If you need practice with List Processing, do 
the exercises in Chapters 3 and 4. 


List Processing must be active on your system. For information on activat- 
ing the feature, see Chapter 2. 


Type the List Document 


e Use the C option from the Main Menu to create a list document. 
e Type any comments inside a control command. 


e Decide what fields to include in your list document. Use separate 
fields in the list document for any piece of information you may 
want to have by itself in a letter or table. 


e Choose field names. Once you have chosen the names, you must 
spell them the same way in every record. 
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Summary of List Processing 


Type the <field name>, the value of the field, and then press 
RETURN. When you have typed all the fields for that record, type 
the diamond <> to end the record. Then press RETURN twice. 


Continue creating records. 


When you are creating a new application, file the document after 
typing three or four records. Create a sample form document and 
selection specification, as outlined below. Then run List Processing. 
Once you have run List Processing and are satisfied with the out- 
put, you can add more records to the list document. 


Type the Form Document 


Create a form document using the C option from the Main Menu. 
Start by typing what you want the first copy to look like. Include 
the <field names> where appropriate. Make sure the text, rulers, 
and highlighting are the way you want them. 


Remember to put a NEW PAGE mark at the end of the form docu- 
ment if you are creating a form document, such as a letter, that uses 
one sheet of paper for each record. 


File the form document when you are finished. 


If you are inexperienced at List Processing, make a sample form 
document to prove that List Processing is working as you want it to. 


Type the Selection Specification 
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Create a selection specification. End each specification with process 
record. 


File the selection specification document when you are finished. 
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Run List Processing 


When all three documents are ready, you can run List Processing. 


1 
2 


From the Main Menu, type LP and then press RETURN. 


Type P and press RETURN to send output to the printer. Or type D 
and press RETURN to send output to a document. 


If you are testing your sample document, choose the P option to get 
printed results to examine. 


Type the name or number of your list document. Press RETURN. 


Type the name or number of your selection specification. Press 
RETURN. 


Type the name or number of your form document. Press RETURN. 


If you send the output to a printer, examine the Print Menu set- 
tings. Change the settings as necessary, type YES or OK, and then 
press RETURN. 


If you send output to a document, name the document to receive 
the results of List Processing. If the document already exists, 
decide how it is to be modified, and press RETURN. 


Specify any FR and TO settings necessary. Type GO and then press 
RETURN to begin. 


The output from List Processing begins scrolling on the screen. If you choose 
the P option, the output prints. When List Processing finishes, press Gold 
MENU to recall the Main Menu. 


/\ 


Glossary 


Italicized words are also entries in the glossary. 


abbreviation document 


A document where frequently used words and phrases can be stored. 
Each entry is identified by a two-character abbreviation, used to invoke 
the stored text. Compare library document. See the User’s Guide. 


activate 
To introduce an optional feature, such as List Processing, onto the 
system diskette. 

application 
A specific task that can be performed using word processing basic soft- 


ware and, at times, the optional features. For example, a mailing list 
application might use List Processing. 


ASF 


See automatic sheet feeder. 
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Glossary 


automatic sheet feeder 
(ASF) An accessory for the letter quality printer that feeds individual 
sheets of paper to the printer. 

basic software 
The instructions on the system diskette that allow DECmate to perform 
word processing. 

comments 
Optional text included at the beginning of the list document that is not 
part of any record. Comments usually explain the field names and other 
relevant information. 

data base 
Stored sets of information that are used to generate reports, mailing 
lists, and so on. The list document is a data base. 

diamond 
The left and right angle brackets <>, with no text between them, used 
to mark the end of a record in a list document. 

empty field 


A field name without a field value. 


feature 
Software that performs a specialized task. Features such as global 


search-and-replace are part of DECmate’s basic software. DECmate 
offers optional features such as List Processing and Communications. 
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Glossary 


feature diskette 


A diskette that activates an optional feature. 


field 


The basic unit of information in a record. For example: 


€zip?O30sd 


In this example, the field name, enclosed in angle brackets, is zip; the 
field value is 03054. 


field name 


The text enclosed in <angle brackets> in a list document. 


field value 


The text following the right angle bracket > that ends a field name up 
to the next left angle bracket <. 


form document 


In List Processing, the document that contains text to be printed repeat- 
edly. It also shows where to merge variable information from the list 


document. 


invisible character 


Can be either 1) a character that is not visible during normal editing 
mode, such as a centering mark, but can be viewed in view mode as a 
symbol or abbreviation, or 2) a character visible on the screen, such as a 
PAGE MARKER, that is not visible in the printed document. 
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Glossary 


invisible hyphen 
An invisible character that tells the system where to hyphenate a word 
if necessary. 

leader 
The text printed at the top of a form document, before the <!S> com- 
mand that begins the repetitive area. 

library document 
A document used for storing frequently needed text. Each entry is iden- 
tified by a short name, used to invoke the stored text. Compare abbrevi- 
ation document. 

list document 
A document containing records of information. In List Processing, 
records from the list document are merged with a form document. 

List Processing 
The optional feature that produces many copies of a form document with 
certain information changing from one copy to the next. 

List Processing Menu 
The menu that: displays when the LP option is selected from the Main 
Menu and the List Processing feature is active. 

Math 


The optional feature that allows DECmate to perform mathematical cal- 
culations while you edit or run List Processing. 
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_ Glossary 
missing field 
A field that is not included in a specific record in a list document. 
= numeric field 
A field with a field name that begins with a colon (:) and has a numeric 
al : 
value as the field value. 
optional feature 


A feature purchased separately from the basic word processing software. 
rm DECmate offers List Processing, Sort, Math, and Communications as 
optional features. 


ro output document 
_ The document generated when you run List Processing. 
overwrite 
es To replace text in a document with new text. 
record 
A group of related fields in a list document. For example: 
«name>John Doe 
aaceal <addr>P.0. Box 1 
<citysMerrimack 
rom <State>NH 
SZ1P203054 
pare; Se 
In this example, the five fields contain information on a particular per- 
4 son. The diamond <> marks the end of the record. 
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repetitive area 


The name given to all text and commands between the start <!S> com- 
mand and the end <!E> command. Usually, records are processed 
sequentially in the repetitive area. The leader and trailer are printed 
only once. 


result document 


See output document. 


selection specification 
Instructions defining which records from the list document will be 
merged with the form document. 

sentence 
In List Processing, the list of acceptable values in the selection specifica- 
tion that begins with if and ends with process record. 

short name 
A word enclosed in double angle brackets, such as <<type>>, that 
specifies a unique entry in the library document. 

software 
A set of instructions for the computer. For DECmate, software is stored 
on the system diskette. 

Sort 
The optional feature that examines a list document and produces another 


list document with the records rearranged in ascending or descending 
order. 
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Glossary 


specification document 


One of the three List Processing documents. Contains the selection spect- 
fication that determines which fields and records from the list document 
to merge with the form document. 


sublist 


A list containing selected records from a list document. 
trailer 
The text printed at the end of a form document, after the <!E> com- 


mand that ends the repetitive area. 


value 


See field value. 
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A option, 5 

Abbreviation document, 41 

Activate Features Menu, 5, 6 

Activating list processing 
bad feature diskette, 9 
procedure, 7 

Advancing to next record, 52 

Alphabetical order, 16 

And, 57 

Angle brackets, printing, 55 

Asterisk, <*>, 60 

Automatic sheet feeder, 45, 46 


B 

B option, 29 

Bad feature diskette, 8 
But not if specification, 50 


Index 


Cc 


Comments, 40 

Copying list, 54 

Copy sublist, <!R>, 54 
Cut-and-paste, 18, 40 


D 

D option, 29, 30 

Dates as numbers, 66 to 67 
Deleting record, 40 

Diamond, <>, 53 

Diamond, in record, 12 

Directory of customers, example, 46 
Diskette, feature, 7 

Diskette Maintenance Menu, 5, 6 
Document Modified Display, 29, 34 


E 

Empty field, 41, 42, 59 

End, <!E>, 47 

ENTER key, 14 

Error in selection specification, 37 

Exercises 
create a form document, 22 
create a list document, 18 
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Exercises (Cont.) 
create a selection specification 
document, 25 
running list processing, 33 


F 

Feature diskette, 7 

Field 
contents of, 12 
empty, 41, 42 
invisible character, 14 
missing, 41, 42 
numeric, 42, 62 to 67 
order of, 16 

Field name 
contents of, 13 
in form document, 12 
in list document, 12 
in records, 12 
restrictions on, 13 
variations of, 13 

Field value 
contents of, 12, 14 
invisible character, 14 
invisible hyphens, 14 

Form document 
description of, 19 
field names in, 21 
formatting in, 21 
hyphen in, 21, 39 
leaders, 47 to 53 
repetitive area, 47 
rulers in formatting, 21 
rulers in table, 50 
sublist, 55 
tables, 46 to 55 
trailers, 46 to 53 
word wrap, 21 

Form document, examples of 
continuous-form envelope, 44 
directory of customers, 46 
individual envelopes, 45 
labels, 45 
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Form document, examples of (Cont.) 
letter, 20 
multiple columns, 46 
parts list, 48 

Form letter, 1, 20 

From (FR), 30, 31 


G 
Gold HALT, 35 
GO option, 30, 31 


H 
Hyphen, invisible, 21, 39 


| 
Invisible hyphen, 21, 39 


L 
Large lists, processing, 36 
Leader, in table, 47 to 53 
Left angle bracket command, 
<<, 55 
Library document, 41 
List, copying, 54 
List document 
comments, 40 
description of, 11 
fields to include, 14 
order of fields, 16 
order of records, 16 
printing, 17, 41 
records in, 12 
List processing 
overview of, 1 to 3 
summary of, 69 to 71 
List processing feature diskette, 7 
List Processing Menu, 27, 33, 34 
List Processing Start Menu, 28, 30, 
31, 33, 34 
List size, 16, 36 
LP option, 7, 27 
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M 
Math 
in tables, 47 
in selection specifications, 63 
using, 42 
with List Processing, 9, 17 
MC option, 5 
Missing field, 41, 42, 59 
Moving a record, 40 
Multiple column form, 46 


N 
NEW PAGE mark, 21, 22 
No output, 32, 35 
Number of records, 12 
Numbers, testing 
character for character, 63 
digits only, 63 
numerically, 62 
Numeric fields, 17, 42 
range, 65 
rules for creating, 43, 44 
in selection specification, 62 to 67 
in table, 47 


O 

O option, 29 
Optional feature, 1 
Or, 57 

Or if, 58 

Or less, 65 

Or more, 65 

Order of fields, 16 
Order of records, 16 
Output document, 31 
Overview of list processing, 1 to 3 


Pp 

P option, 28, 30, 33 
Page size, 45 

PARA key, 12 

Parts lists, example, 48 


Printer 
output to, 31 
stopping, 35 
Print Menu, 28, 33, 35 
Process record, 23 


Q 


Question mark <?>, 60 


R 
R command, 36, 45 
Ranges, numeric, 65 to 67 
Records 
deleting, 40 
description of, 11 
example of, 12 
fields in, 12 
limit on number of, 12 
limit on size of, 12 
moving, 40 
order of, 16 
rejecting, 58 
size of, 12 
skipping, 53 
Rejecting record, 58 


Repetitive area, in table, 47 


Rulers, in table, 50 
Running list processing, 27 


S 

SE print setting, 36, 45 

Selection specification 
description of, 23 
empty fields, 59 
error in, 37 
missing fields, 59 
numbers in, 62 to 67 


numeric ranges, 65 to 67 


rulers, 24 

sentence, 58 

testing, 37 

types of, 23, 57 to 67 
wildcards, 59 to 61 


83 


Sentence, 58 

Size of record, 12 

Skipping records, 53 

Software, 1 

Sort, 9 

Start, <!S>, 47 

Start Menu, List Processing, 30 

Stopping list processing, 35 

Sublist, 55 

Summary of form document 
commands, 56 


Summary of list processing, 69 to 71 


T 
T option, 29, 37 
Tables, 46 to 55 
advancing to next record, 52 
copying list, 53 
double spacing, 49 
producing, 46 
rulers in, 50 
skipping records, 53 
tabs in, 50 
Testing selection specification, 37 
Testing several fields, 57 
Through and Thru, 65 
TO option, 30, 31 
Trailer, in table, 46 to 53 
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Wildcards, in selection 
specification, 59 to 61 
Word wrap, 21 
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HOW TO ORDER ADDITIONAL DOCUMENTATION 


DIRECT TELEPHONE ORDERS 


In Continental USA In Canada In New Hampshire, 
and Puerto Rico call 800-267-6146 Alaska or Hawaii 
call 800—258—1710 call 603-884-6660 


| DIRECT MAIL ORDERS (U.S. and Puerto Rico’) | 


DIGITAL EQUIPMENT CORPORATION 
P.O. Box CS2008 
Nashua, New Hampshire 03061 


DIRECT MAIL ORDERS (Canada) 


DIGITAL EQUIPMENT OF CANADA LTD. 
940 Belfast Road 
Ottawa, Ontario, Canada K1G 4C2 
Attn: A&SG Business Manager 


INTERNATIONAL 


DIGITAL EQUIPMENT CORPORATION 
A&SG Business Manager 
c/o Digital’s local subsidiary 
or approved distributor 


Internal orders should be placed through the Software Distribution Center (SDC), Digital 
Equipment Corporation, Northboro, Massachusetts 01532 


*Any prepaid order from Puerto Rico must be placed 
with the Local Digital Subsidiary: 
809-754-7575 
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Reader's Comments 


Your comments and suggestions are welcome. They will help us in our contin- 
uous effort to improve the quality and usefulness of our publications. 


1 How would you rate this manual for: 
good fair poor 
completeness of information 
accuracy of information 
ease of use (clarity, organization) 
2 Did you find errors in this manual? Please specify by page and paragraph, 
or mark corrections on pages and attach copies to this form. 
page paragraph 
a) Incorrect information: 
b) Information left out: 
c) Hard to understand: 
3 What suggestions do you have for improving this manual? 
4 What parts of the manual were especially good at helping you understand 
things? 
5 Please check the boxes that apply to you. 
(J Technical L] Used other word processors 
L] Nontechnical L] Used computers 
L] Management L] Use the word processing unit 
L] Nonmanagement yourself 
LJ] Other (explain) 
Name____—COFsC—CSCSCS 7 CTTtSCS<ST i tid? 
Company 
Street__._. CC tY 
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